home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / mxlibs / vat060 / readme.txt < prev    next >
Encoding:
Text File  |  1995-05-27  |  5.5 KB  |  140 lines
  1.                       VARMINT'S AUDIO TOOLS Information
  2.                              VERSION 0.6  (beta)
  3.  
  4.                       Sound Blaster programming library
  5.  
  6.                              Eric Jorgensen 1995
  7.  
  8. DISCLAIMER
  9.  
  10.   This software and documentation is provided as-is and is not
  11.   garanteed to do or be anything.  Use at your own risk.
  12.  
  13. INTRODUCTION
  14.  
  15.   Varmint's Audio Tools (VAT) is a small Sound Blaster programming Kit.
  16.   It's primary feature is a DSP interrupt driven core that handles
  17.   real-time mixing and playing of digital sounds, background MIDI
  18.   music, and backgroun MOD music.   It supports many FM chip routines, 
  19.   input functions for WAVE samples, MIDI music files, and MOD music files, 
  20.   true MPU-401 MIDI output, auto recognition and setup of Sound Blaster 
  21.   compatable cards, millisecond clock and microsecond-accuracy timers. 
  22.   VAT is Freeware and comes with source and example code (Turbo C).
  23.  
  24.   The inspiration for VAT came from Peter Sprenger's library called SOUNDX.  
  25.   (There are still a few snippets of Peter's code hanging around in VAT.)  
  26.   Special thanks go to Peter for writing the first sound library that I
  27.   could get to work on my computer.
  28.  
  29. SO WHO NEEDS IT?
  30.  
  31.   VAT is intended for any programmer who wants to add sound effects
  32.   and music to their programs quickly and easily.  
  33.   Like so many other programmers, I've been very dissappointed by the
  34.   sound library offerings out there.  I have designed VAT to be very easy
  35.   to use and as versatile as possible, and I hope that it is useful to you.
  36.  
  37.   When dealing with routines that run in the background, most programmers
  38.   are concerned about how many CPU processing cycles the routines use up.  
  39.   Here are the numbers that I get on my 486 DX2/66:
  40.  
  41.   Base overhead:  2.8 %
  42.   Midi overhead:  1.0 % (average)
  43.   Sample overhead: 1.0% per sample
  44.   MOD overhead: 6% (per active channel)
  45.  
  46.   So, let's say that your program is playing some midi music and 4 digital
  47.   samples in the background.  The total overhead would be: 2.8% (base) +
  48.   1% (midi) + 4 * 1.0% (samples) = 7.8%.  That means that
  49.   if you were animating some graphics at 30 FPS, it would slow down to
  50.   27 FPS.  Pretty acceptable, especially considering that these numbers
  51.   can be improved with compiler optimizations.
  52.  
  53.  
  54. FEATURES
  55.  
  56.   - Background DMA digital playback with real time mixing and
  57.     unlimited channels.
  58.   - Variable speed playback and volume control of individual sounds.
  59.   - Background Playing of MIDI music with easy control of tempo and volume.
  60.   - Background Playing of MOD music with easy control of tempo and volume.
  61.   - Routines to access the FM chip.
  62.   - MPU-401 true MIDI output.
  63.   - Vertical retrace checking functions for animators.
  64.   - Millisecond (adjustable) clock plus microsecond accuracy timers.
  65.   - Auto recognition and setup of Sound Blaster or Sound Blaster
  66.     compatable sound cards.
  67.   - Does not disturb the system clock (does not use int08)
  68.   - Comes with heavily commented source code, demo, and example code.
  69.  
  70. BETA VERSION
  71.  
  72.   BETA means bugs.  I am trying very hard to get rid of bugs in
  73.   VAT, but this is especially tricky when I am trying to get it to 
  74.   work with so many Sound Blaster configurations on so many platforms.
  75.   I am relying heavily on people like you to try out VAT and report
  76.   any problems.  Please help me make this a great tool!  If the demo
  77.   crashes on your computer, please run VAT with debug in the command line.
  78.   This will dump extra information to the survey.txt file that will
  79.   help me to figure out what is wrong.
  80.  
  81. HOW TO CONTACT THE AUTHOR
  82.  
  83.   Any suggestions or bug reports are very welcome.  (The demo program
  84.   creates the file "survey.txt" to make this process easier you.) Please 
  85.   send them to one of these email addresses:
  86.  
  87.             smeagol@rt66.com
  88.             ejorgensen@rr5.intel.com
  89.  
  90. FREEWARE (LISCENCING)
  91.  
  92.   VAT is freeware, so you are free to copy and distribute this library
  93.   as much as you like as long as you charge no fee for it's distribution.
  94.   (The exception to this is if VAT is distributed as part of a large
  95.   collection of shareware/freeware packages.) You are NOT restricted, 
  96.   however, from charging money for games or other programs that use 
  97.   VAT to produce sound.  All I ask is that you send me a complimentary 
  98.   copy.   This helps me as a developer to know who is using my software 
  99.   and for what.  It is also a good way to make friends!
  100.  
  101.   In other words:
  102.  
  103.     Q: Can put any of the programs or example code from VAT into my
  104.        own shareware that I am going to sell for money?
  105.  
  106.     A: Absolutely not.
  107.  
  108.     Q: If I use VAT to generate sounds in my game, can I sell my game
  109.        for money?
  110.  
  111.     A: Yes!  (Please send Eric Jorgensen a complimentary copy of your game!)
  112.  
  113. VARMINT'S HOME FTP SITE
  114.  
  115.   I have a home site for all of my software:
  116.  
  117.       mack.rt66.com:/users/smeagol
  118.  
  119.   Here you can find my other shareware and freeware offerings:
  120.  
  121.     tmkr11.zip          Terrain Maker - A random Terrain generator/
  122.                         editor for the freeware raytracer Persistence
  123.                         of Vision (POV).
  124.  
  125.     vpova10.zip          Varmint's POV animator - A POV scene file parser
  126.                         that allows the inclusion of functions and
  127.                         animation commands.
  128.  
  129.     svgaccft.zip        50 fonts for SVGACC
  130.  
  131.     svgadiag.zip        Free SVGA diagnostic utility
  132.  
  133.     survey_results.txt  Compiled results of a large survey of SVGA cards
  134.                         that I performed in December of 1994.
  135.  
  136.  
  137.  
  138.  
  139.  
  140.